home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
qbbs
/
cbs_121q.zip
/
CBS_Q.DOC
next >
Wrap
Text File
|
1990-05-17
|
31KB
|
1,074 lines
COMPUTER SOFTWARE ASSOCIATION
CALL BACK SYSTEM
Version 1.20
Written by
Patrick Stierman
Sysop: Micro Hub BBS (602) 649-9412
Documentation by: Patrick Stierman and John Bierrie
Copyright (C) 1990, Computer Software Association
Copyrighted @ Feb,1990
ALL RIGHTS RESERVED
CONTENTS
--------
I. Introduction................................. i
Copyright Notice............................. ii
Shareware License............................ ii
Shareware Registration....................... iii
Warranty and Limit .......................... iii
II. Installation................................. 1
CBSinst.Exe................................ 3
Local.Ctl.................................. 6
III. Appendix A
Sample Batch Files......................... 8
IV. Appendix B
Sample Menu & Registration Questionnaire... 11
V. Appendix C
Support Systems............................ 12
VI. Registration................................. 13
VI. Notes........................................ 14
INTRODUCTION
************
This program was written to serve the needs of all high speed
modem users. While trying to get several of the common Call
back verifiers up and on-line with my BBS I came to the
conclusion that these programs were written for the low speed
modem users. Higher speeds and Locked port support was added
as an afterthought. These programs were often well written
but the programmer had no way to test out the code. Thus
along came the 'well it works for me it should work for you
syndrome. After several months of fighting these problems I
decided to write a Call Back Verifier program that WORKS with
the HST modems and others that use Locked Baud rates to the
fossil. Thus along came this Program.
I wrote this program to support my BBS only, when someone
else heard I had one that worked. Thus a shareware version
came to be. I had only supported locked baud rates in the
original program and had to allow for floating connect rates.
The program was rewritten to include these support functions.
Then came the realization that not everyone had 100% Hayes
compatible modems. Oh well, back to the drawing board and out
comes the config.dat file. Trying to keep required files at a
minimum I had to add only one more file to define local calls
for those who don't want to call all over the USA on
their dime. Local.ctl fills that requirement. Thus to run
this program, there are only three files required instead of
the 6 or more for most other verifiers.
As with all programs there will be upgrades and revisions as
the users request or demand options I didn't think of. The
latest version of this software will always be available for
D/L on the support BBS's Fido addresses 322/235 and 114/70.
The boards are HST and up 24 hours except during ZMH. Stop by
and also check out some of the other fine software available
on these BBS's. The newest release of CBS will always be
available for D/L on these BBS's. You may also FREQ CBS on
322/235 or 114/70 as CBS_Q and get the latest release that
way.
i
COPYRIGHT Notice
******************
No part of this manual may be reproduced, transmitted or
translated into any language, in any form or by any means,
except as described in the following license with out the
prior written permission of Patrick Stierman.
You are granted a limited license to use this software
described in this manual. The software may be used or copied
only in accordance with the terms of the license agreement
within this manual.
SOFTWARE LICENSE
================
This software is provided to run on one machine and one
machine only. It is non-transferable. You may use this
software on a limited basis for a trial period (30)days.
After this evaluation you must either register it or cease to
use said software.
You may make copies of this software to be distributed only
in the original format and package. You may NOT delete any
files from the initial distribution package. The archived
file must remain intact. You may NOT charge any fee for this
service to distribute.
You may upload the distribution archive to any bbs you desire
as long as the software has not been modified.
CBS's Call Back System must not be released or included in
any other software package with out a written agreement from
"CSA", Computer Software Association.
Operators of BBS systems or electronic mass media systems may
post the original unmodified archived package for download by
their users without written permission as long as no fee is
charged for the downloading of the file. Access fees may be
charged but no fee must be charged for the specific
downloading of CBS.
ii
SHAREWARE Registration
**********************
Computer Software Association's Call Call Back System is not
PUBLIC DOMAIN software. It is SHAREWARE. If you use it for
more than the trial period (ie 30 days), You must pay and
register it. The registration fee is a mere $12.95 (non
commercial), $50.00 (commercial). Registration entitles you
to bug fixes, notification of NEW RELEASES and registered
versions of the new releases until otherwise stated by CSA.
The registration form is located at the end of this manual.
Please fill it out completely to allow us to contact you
should the need arise. That is to forward any bug fixes that
HOPEFULLY will never be required.
MAIN SUPPORT BBS's:
Micro Hub BBS Doc's Place BBS
Fido 1:114/70 Fido 1:322/235
(602) 649-9412 (508) 520-4564
Registration information
Please make all checks or money orders payable to:
CSA
Send to: CSA
C/O John Bierrie
658 Old West Central St.
Franklin, Ma 02038
There are no warranties associated with this software,
either expressed or implied. The user of this program assumes
all responsibility for operation of this program and any
damages resulting from its use.
The "commercial" registration entitles you to other services
not mentioned in this document. For further information,
contact John Bierrie directly.
WARRANTY and LIMITS
*******************
This software is provided AS IS without any expressed or
implied warranties whatsoever. No warranty of fitness for a
particular purpose is offered. The author of this software
cannot be held responsible for DIRECT, INDIRECT INCIDENTAL,
CONSEQUENTIAL, or ANY OTHER damages due to your ability or
inability to use this software, even if the author has been
advised of the possibility of such damages. The user assumes
full responsibility for the use of this software.
iii
FILES INCLUDED IN THIS PACKAGE
------------------------------
CBS.EXE <------ Actual CBS program
CBSINST.EXE <------ CBS installation program
CONFIG.DAT <------ Sample Configuration file
CBS_Q.DOC <------ These Documents
CBS.MNU <------ Sample Menu
REGISTER.Q-A <------ Sample Registration Questionnaire to work
with CBS menu
REGISTER.ASC <------ Sample explanation file for CBS
READ.ME <------ Last minute changes, information, etc.
SYSTEM REQUIREMENTS
-------------------
Quickbbs 2.6? or greater
MS-DOS 2.1 or later
HAYES compatible modem
INSTALLATION
------------
Welcome to CSA's Call Back System. With this program, Sysops'
have the ability to upgrade new user access automatically.
This version supports Quickbbs 2.6? versions and above
unless they do some drastic changes in the code with future
releases. There are two support files required with this
program and are supplied in the distribution package. There
are also three sample files, one Menu and one Questionnaire
and an Information file. Their usage is described separately
later on in the documentation.
***********CBS MUST BE RUN AS A TYPE 15 EXIT!!***************
CBS will support all valid baud rates and if you have your
com port locked it will support that too.
SWITCHES
--------
/L LOCKED PORT
This command line switch tells CBS the modem and com port
are locked to the following speed.
CBS /L=19200 or /L=38400
1
/C CALL BACK SYSTEM
Directs CBS to act as a "Call Back System" and not upgrade
the user's Security Level or Flags.
CBS /L=19200 /C /F=\Logs\CBSCBACK.LOG
/F LOG FILE
You may specify a separate log file for CBS, or default to
the Quickbbs "System.log" :
CBS /F=CBS.Log for CBS's own log
/F= Supports Full Drive and Path format
NO command line switch /F will result in default to the
Quickbbs System.Log
/T TEST MODE
To test CBS in LOCAL mode.
CBS /T
CBS also *** MUST *** have the modem configured to disconnect
users by dropping DTR. In the next version we will add support
to disconnect users with modem control strings.
2
CBSINST.EXE
-----------
********************** FIRST OF ALL!!!! *********************
If you were running a previous version of CBS, (before 1.10)
delete the OLD Config.Dat file before running CBSINST !!!
--------------------------------------------------------------
Run CBSINST to setup CBS. It will create a file called
Config.dat. This is where the program gets its information on
what it does with each user. It has provisions for setting
the new security level and for changing all of the user's
flags. These changes take effect immediately after
verification of password and re-entry into Quickbbs.
Use keys F2 to exit and F1 to Save/Exit the CBSINST program.
New User
Is the level each new user has prior to verification
and is a number from 1 to 32000. It must not be a 0
as zero is what Quickbbs uses to lock out a user
hence, someone with this level would never have
access to this program.
Member
Is the NEW security level you wish a verified user
to have. It also must be an integer between 1 and
32000.
3
SECURITY FLAGS
The next four entries are for upgrading the user's
Flags when they have been verified. Each set of flags
can have 2 states, [on] or [off]. By using one of
the 4 options for each flag, you have complete control
over what CBS does to the flags. (You must put one in
each flag slot!!)
The options are:
<*> Tells CBS to ignore this flag. Whatever
state the flag was in remains after
verification.
<X> Force this flag ON. No matter what the
flag was. It will be forced on.
<-> Force this flag off. Again as above no
matter the original state this flag
will be forced off.
<?> This toggles the flag. If it was
originally ON it is changed to OFF.
Likewise if it was originally OFF it
will be changed to ON.
MODEM INITIALIZATION
In this release, it is NOT mandatory to set your
initialization string. This should be set however,
to speed in upgrading to newer versions of CBS,
as later releases will implement this.
MODEM DIAL PREFIX
These are the codes sent to the modem prior to
dialing a number. Normally ATDT for Hayes
compatible modems. This can also be used for
entering in any special dialing commands you might
need, such as a "9" for outside lines and the like.
ATDT~9~~
MODEM DIAL SUFFIX
Is the command set to the modem after the dial
string is sent. Normally a | or <cr>. This
instructs the modem to begin dialing the number.
MODEM OFF HOOK COMMAND
The is the command the modem needs to go OFF HOOK,
that is, to pick up the phone. It is usually ATH1|
4
MODEM ON HOOK COMMAND
This is the command to tell the modem to HANG UP
the phone, or go "on hook". It is usually ATH0|
DEFAULT AREACODE
Area code CBS will use if user neglects to enter
one when initially logging on.
SYSOP NAME
Your name. Use only a space between first and last
name.
RESUMEBBS
Is a Y or N entry telling CBS to either log off
after verification or Resume BBS operation. A <Y>
will allow the user back into the calling menu
in Quickbbs.
LocalResume
To allow the system to call back "local" users as
defined in the Local.ctl file.
LD Resume
To allow the system to call back "Long Distance"
numbers. Any phone number entered as long distance
in the Local.ctl file.
LOCAL COLOR
This Flag will toggle Local Color on and off only
on the local display. Color will still be display
to the user if his graphics flag is on.
DUP CHECK
This is either a Y or a N telling CBS to check
for duplicate phone entries.
CHECK LEVEL
If you specify Y in the previous entry Dup Check,
then you will need to set the level of checking.
Level 1 or 2 is to be set as follows:
Level 1
Send only a report to your system log. It will
log the name of the current user as well as the
name of the user that also has that same phone
number.
Level 2
Check for duplicate numbers, then LOCKOUT that
user record IF the phone number duplicates
another users.
5
LOCAL.CTL
*********
LOCAL.CTL is the file that tells CBS which numbers are local
calls. You can now tell CBS to call any number anywhere. But
you will still have full control on what numbers will be
allowed. We did this to allow users in large towns or densely
populated areas that have many local or low cost dial zones.
CBS now looks at the local.ctl file a little differently than
before. There are now several control characters that CBS
uses to control the dialing of the modem. Shown in the sample
below are the flags and how they work.
All new area codes must be precede with one of the 4 flags
allowed. Else CBS will not be able to tell the difference
between a new area code or just additional prefixes for the
last area code. The flags are described below.
SAMPLE LOCAL.CTL
+602
@602
213
123
456
234
789
#789
790
791
!792
145
235
236
etc....
>>>NOTICE<<< each prefix is on it's own line with nothing
following. The file must follow this layout exactly or else
the program will fail to find matches and all numbers would
appear as Long Distance calls and CBS won't call them.
Description of AreaCode Flags:
(+) Is the first entry and tells CBS the actual
AREA CODE which is local. ie Put your area
code here.
(@) Tells CBS that all prefixes that follow are
local calls and are ok to call. CBS will
call the number as a 7 (seven) digit
number. ie (999-9999).
6
(#) Tells CBS that there is a new area code or
that the dialing conditions have changed.
The # flag denotes that the next set of
prefixes require a 1 in front of the number
to dial that number. The prefixes that
follow are also OK to dial.
($) Tells CBS that there is a new area code or
that the dialing conditions have changed.
The $ flag denotes that all prefixes that
follow are OK to dial and require 1+area
code+ number to dial.
CBS Will still NOT call any prefix or number unless it is
included in the local.ctl file. It works that way to give
the sysop total control over who CBS calls. That way CBS
can't call Long Distance unless YOU tell it to.
Area codes can be duplicated under different flags as it
is quite possible to have local calls to certain prefixes
and also Long distance calls in the same city to different
prefixes.
Example Local.ctl :
+602
@602
464
#602
986
1. 602-464-1270
and
2. 602-986-1111
Phone number one is local to my area and phone number
two is long distance. Number 2 requires a 1 in front
of the number to dial where as number 1 does not.
These would go into the Local.ctl files like this.
This tells CBS to call 464 as local and 986 as
1+number. As long as the prefixes are in Local.ctl then
they are valid numbers to call. If you exclude any
prefixes in the area then CBS won't be able to call
that number as it can't find them in the Local.ctl
file. This is a way to eliminate certain areas from
being able to be called. (why someone would so this I
really can't tell, But it is there just in case)
Numbers such as 911 cannot be dialed as no one would
actually have 911 as a prefix to their number. Thus 911
calls are filtered out totally. Neat huh.... If 911 is
not in the Local.ctl file then CBS won't dial it.....
7
APPENDIX A...
SAMPLE BATCH FILES
The following is an extraction from my Mailer.bat file
that runs Micro Hub BBS. CBS works here with this setup
quite well. I am sure there are other ways of doing this
but this works for me.
STAND-ALONE Quickbbs BATCH FILE
-------------------------------
:After_Quickbbs
If Errorlevel 61 goto start
If Errorlevel 60 goto Leech
If Errorlevel 51 goto Start
If Errorlevel 50 goto CBS
If Errorlevel 41 goto Start
If Errorlevel 40 goto Bimodem
If Errorlevel 11 goto Start
If Errorlevel 10 goto Outside
If Errorlevel 5 goto Net_Echo
If Errorlevel 4 goto Echo_Only
If Errorlevel 3 goto Net_Only
goto Start
...
:CBS
CBS /l=19200
goto Restart_Quickbbs
:RESTART_Quickbbs
cd\qbbs
Quickbbs -r -e0
goto After_Quickbbs
...
:out
Echo MicroHub BBS ......GOING.....GOING.....GONE
8
Quickbbs WITH MAILER SAMPLE BATCH FILES
---------------------------------------
Sample batch file to work with Front Door, DBridge, etc...
@ECHO OFF
:start
c:
cd\fd
fd
if ERRORLEVEL 200 goto unpackmail
if ERRORLEVEL 196 goto 9600_Baud
if ERRORLEVEL 124 goto 2400_Baud
if ERRORLEVEL 112 goto 1200_Baud
If ERRORLEVEL 36 goto local
if ERRORLEVEL 1 goto out
if ERRORLEVEL 0 goto start
goto start
:9600_Baud
cd\fd\Quickbbs
Quickbbs -b2400 -E0 -P
if ERRORLEVEL 30 goto CBS
if ERRORLEVEL 14 goto CBSCBACK
goto After_Quickbbs
:2400_Baud
cd\fd\Quickbbs
Quickbbs -b2400 -E0 -P
if ERRORLEVEL 30 goto CBS
if ERRORLEVEL 14 goto CBSCBACK
goto After_Quickbbs
:1200_Baud
cd\fd\Quickbbs
Quickbbs -b1200 -E0 -P
if ERRORLEVEL 30 goto CBSCBACK
if ERRORLEVEL 14 goto CBS
goto After_Quickbbs
:After_Quickbbs
if ERRORLEVEL 9 goto start
if ERRORLEVEL 6 goto Maintain
if ERRORLEVEL 5 goto Net&echo
if ERRORLEVEL 4 goto Echo
if ERRORLEVEL 3 goto Net
if ERRORLEVEL 0 goto start
goto start
:CBSCBACK
CBS /L=19200 /C /F=C:\logs\callback.log
goto Restart_Quickbbs
:CBS
CBS /L=19200 /F=C:\LOGS\CBS.LOG
goto Restart_Quickbbs
9
:Outside
CTTY COM2:
WATCHCD COM2: ON
<PROGRAM NAME>
WATCHCD COM2: OFF
CTTY CON:
goto Restart_Quickbbs
:Restart_Quickbbs
Quickbbs -R -E0 -P
if ERRORLEVEL 30 goto CBSCBACK
if ERRORLEVEL 14 goto CBS
goto After_Quickbbs
:out
10
APPENDIX B...
SAMPLE MENU & REGISTRATION QUESTIONNAIRE FILES
---------------------------------------------
Included with the CBS System package are four additional files to
help you make a "Clean and Neat" installation of the CBS program.
You are welcome to use them, modify them or just plain throw them
out...
CBS.MNU
Call this menu up from your "TOP" menu using whatever
command you are comfortable with. I use "R". This menu
will allow the user to read about the "whys and hows" of
the CBS system, answer a Registration Questionnaire and then
use the CBS program itself.
NOTE: If you use this menu, please remember to "Edit" line
# 10 of the menu to reflect your name.
REGISTER.Q-A
Sample Registration.Q-A used by this system.
REGISTER.ASC
Sample "Information" file accessed by the CBS.MNU explaining
a little about who needs to use the CBS, why it is used and
what to expect while using it.
11
APPENDIX C...
SUPPORT SYSTEMS
---------------
The following boards act as "Support Systems" for CBS and related
products. Each system carries the latest release of CBS requestable
with the Magic name of "CBS_R". Each system is also tied together via
NetMail to insure the fastest responses to any questions or concerns.
WESTERN REGION EASTERN REGION
-------------- --------------
1:114/70 1:322/235
Micro Hub Doc's Place BBS
Mesa, Az. 85201 Franklin, Ma. 02038
602-649-9412 508-520-4574
Sysop - Patrick Stierman Sysop - John Bierrie
12
Registration FORM
=================
Use your name and BBS name "exactly" as they appear on your system!!
* Sysop's Name...........___________________________________
* BBS Name...............___________________________________
* BBS Phone Number.......___________________________________
* FidoNet Number.........___________________________________
(if applicable)
* Address................___________________________________
___________________________________
___________________________________
* Company Name...........___________________________________
(if applicable)
Costs: Call Back System
- Single copy: $12.95 (non-commercial)
- Single copy: $50.00 (commercial)
- Multiple copy: Write for more information.
Please make all checks or money orders payable to:
CBS
Send to: CBS
C/O John Bierrie
658 Old West Central St.
Franklin, Ma 02038
Registration entitles you to new releases as they become
available. Registration will also entitle you to telephone
support. No number will be given until you have registered.
Any questions until registered, will be handled via snail
mail or FIDO mail address 322/235 114/70 or by logging on to
one of the support BBS,s:
Micro Hub BBS Doc's Place
(602) 649-9412 (508) 520-4574
HST 23 Hours HST 23 Hours
1:114/70 1:322/235
Thank You For Supporting Shareware Software................
13
NOTES
-----